Alias

SignerProcessResultUpdate

Description

Establishes the result of a document signature process.

Request

PUT /trustedx-resources/esignsp/v2/signer_processes/{signature_process_id}/result

Parameters

Name	Type	Usage	Description
`signature_process_id`	path	Required	Identifier of the document signature process whose result is to be established.

Content-Type Header

Content-Type: application/json

Body

The body of the request contains the following JSON object:

{
    "status": {string},
    "details": {
        "message": {string}
    }
}

Property

Usage

Description

status

Required

Result assigned to the document signature process:

"finished": The process finished after all the documents were correctly signed.
"failed": The process finished but no document was signed owing to an error.
"failed_documents": The process finished. Some of the documents were signed, but not all.
"canceled": The process finished but no document was signed because the process was canceled.

details.message

Optional

Additional information on the result of the document signature process.

Authorization

The request must contain a bearer access token generated by an authorization server of the platform. This token must have a scope that includes the urn:safelayer:eidas:sign:process:document value and must be used as explained in RFC 6750. Basically, the access token must be included in an Authorization header as follows:

Authorization: Bearer <token>

The access token must be obtained via a client credentials grant type OAuth 2.0 flow.

Response

Status-Line

If the result of the signature process is established successfully, the HTTP response will contain the following Status-Line (see HTTP Response Status for all the possible cases).

HTTP/1.1 200 OK

Content-Type Header

Content-Type: application/json

Body

If the result of the signature process is successfully established, the body of the response contains the JSON object included in the request

{
    "status": {string},
    "details": {
        "message": {string}
    }
}